package com.bookstore.back.service;

import java.util.List;
import java.util.Map;

/**
 * 后台管理服务接口
 *
 * @author 程序猿_Ti
 * @since 2025-07-19
 */
public interface AdminService {

    /**
     * 获取仪表盘统计数据
     *
     * @return 统计数据
     */
    Map<String, Object> getDashboardStats();

    /**
     * 获取销售趋势数据
     *
     * @return 销售趋势数据
     */
    Map<String, Object> getSalesTrend();

    /**
     * 获取分类销售占比数据
     *
     * @return 分类销售数据
     */
    List<Map<String, Object>> getCategorySales();

    /**
     * 获取管理员个人资料
     *
     * @return 个人资料信息
     */
    Map<String, Object> getAdminProfile();

    /**
     * 更新管理员个人资料
     *
     * @param profileData 个人资料数据
     * @return 是否成功
     */
    boolean updateAdminProfile(Map<String, Object> profileData);

    /**
     * 修改管理员密码
     *
     * @param passwordData 密码数据
     * @return 是否成功
     * @throws RuntimeException 当密码验证失败时抛出异常
     */
    boolean changeAdminPassword(Map<String, String> passwordData) throws RuntimeException;

    /**
     * 获取管理员统计信息
     *
     * @return 统计信息
     */
    Map<String, Object> getAdminStats();

    /**
     * 更新管理员头像
     *
     * @param avatarUrl 头像URL
     * @return 是否成功
     */
    boolean updateAdminAvatar(String avatarUrl);

}
